From 713e6c80fefa0aa9c6f522a9d034165c2cda6884 Mon Sep 17 00:00:00 2001
From: Stefano Zacchiroli <zack@debian.org>
Date: Wed, 16 May 2007 11:23:53 +0000
Subject: [PATCH] describe deps from -dev to shared lib packages and mention
 the binNMU safety issue

---
 debian/changelog                  |  4 +++-
 debian/policy/chapter-libpack.xml | 35 +++++++++++++++++++++++++++++++
 2 files changed, 38 insertions(+), 1 deletion(-)

diff --git a/debian/changelog b/debian/changelog
index 5afac0fb..6184ac8f 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -14,8 +14,10 @@ ocaml (3.09.3-2) UNRELEASED; urgency=low
     - mandate the compilation of *.cm[ao] with debugging information for
       libraries and forbid it for bytecode programs
     - update the Vcs-Svn info to the latest PTS documentation
+    - describe dependencies from a -dev package to its companion shared stub
+      package (if any) and suggest the usage of ${binary:Version}
 
- -- Stefano Zacchiroli <zack@debian.org>  Wed, 16 May 2007 13:09:25 +0200
+ -- Stefano Zacchiroli <zack@debian.org>  Wed, 16 May 2007 13:22:23 +0200
 
 ocaml (3.09.3-1) experimental; urgency=low
 
diff --git a/debian/policy/chapter-libpack.xml b/debian/policy/chapter-libpack.xml
index 01d8c5f4..9d38b0d5 100644
--- a/debian/policy/chapter-libpack.xml
+++ b/debian/policy/chapter-libpack.xml
@@ -17,6 +17,41 @@
                 <para>
                     <filename>libxxx-ocaml-dev</filename> should provide the rest of the library package, in fact anything needed to develop programs using the library. If the library uses other libraries or C libraries, this package should depend on them.
                 </para>
+		<para>
+
+		  <filename>libxxx-ocaml-dev</filename> should depend on its
+		  companion <filename>libxxx-ocaml</filename> package (if any).
+		  The reason is that at compile time the &ocaml-name; compiler
+		  will try to load the shared library stubs, aborting the
+		  compilation in case of failure. Hence the development package
+		  is useless if the corresponding stub package is missing. To
+		  ensure compatibility the dependency among the two packages
+		  should be strictly versioned. In order for the resulting
+		  packages to be <ulink
+		    url="http://wiki.debian.org/binNMU">binNMU safe</ulink> this
+		  requirement states that the dependency should make use of a
+		  <code>${binary:Version}</code> substitution variable.
+
+		  <example>
+		    <title>Dependency from a -dev package to its companion share
+		      library stub package (if any), from the
+		      <application>pcre-ocaml</application> package</title>
+		    <programlisting>
+  Package: libpcre-ocaml
+  Architecture: any
+  Section: libs
+  Depends: ocaml-base-nox-${F:OCamlABI}, ${shlibs:Depends}, ${misc:Depends}
+  ...
+
+  Package: libpcre-ocaml-dev
+  Architecture: any
+  Section: libdevel
+  Depends: ocaml-nox-${F:OCamlABI}, libpcre3-dev (>= 4.5), <emphasis>libpcre-ocaml (= ${binary:Version})</emphasis>, ocaml-findlib (>= 1.1), ${misc:Depends}
+  ...
+		    </programlisting>
+		  </example>
+
+		</para>
 		<para>
 		  <filename>libxxx-ocaml-dev</filename> packages should be in <code>Section: libdevel</code>
 		</para>
-- 
2.30.2